---
tags: [processes, ports, debug]
---

# Buscando PIDs

Retorna os IDs dos processos usados pelas portas e intervalos de portas especificados.

## getPIDs

Retorna todos os IDs dos processos usados pelas portas especificadas.

> `getPIDs(porta: number | number[])`

- Requer `lsof` para **Unix** e `netstat` para **Windows**.

```ts
import { getPIDs } from 'poku';

await getPIDs(4000);
```

```ts
await getPIDs([4000, 4001]);
```

---

## getPIDs.range

Retorna todos os IDs dos processos usados pelo intervalo de portas especificado.

> `getPIDs.range(iniciaEm: number, terminaEm: number)`

- Requer `lsof` para **Unix** e `netstat` para **Windows**.

```ts
import { getPIDs } from 'poku';

await getPIDs.range(4000, 4100);
```

---

:::tip

Se o seu ambiente não incluir o `lsof` por padrão:

**macOS (Homebrew)**

```sh
brew install lsof
```

**Debian, Ubuntu, etc.**

```sh
sudo apt-get install lsof
```

**Arch Linux, etc.**

```sh
sudo pacman -S lsof
```

**Alpine Linux, etc.**

```sh
apk add lsof
```

:::
